home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1990: Night of the Living Disc / Night of the Living Disc.2mg / Dev.CD.5 / Tools / File.Type.Notes / FT.About.90.09 < prev    next >
Encoding:
Text File  |  1990-07-27  |  19.8 KB  |  384 lines  |  [04] ASCII Text (0x0000)

  1. Apple II
  2. File Type Notes
  3. _____________________________________________________________________________
  4.                                                   Developer Technical Support
  5.  
  6.  
  7. About Apple II File Type Notes                                 September 1990
  8. _____________________________________________________________________________
  9.  
  10. This Note accompanies each release of Apple II File Type Notes.  This release 
  11. includes new Notes for file types $B6, $B7, $B8, $B9, $BA, $BD, $C1, and $E0, 
  12. revised Notes for file types $50, $C0, and $C7, as well as an updated list of 
  13. all currently assigned Apple II file types and auxiliary types.
  14.  
  15. We welcome your file formats, suggestions on existing Notes, and your requests 
  16. for file type or auxiliary type assignments.  Please contact us at:
  17.  
  18.                     Apple II File Type Notes
  19.                     Developer Technical Support
  20.                     Apple Computer, Inc.
  21.                     20525 Mariani Avenue, M/S 75-3T
  22.                     Cupertino, CA  95014
  23.                     AppleLink:  AIIDTS
  24.                     MCI Mail:  AIIDTS (264-0103)
  25.                     Internet:  AIIDTS@AppleLink.Apple.com
  26.  
  27. The universal sharing of file formats opens new dimensions to personal 
  28. computing, so we want Apple II File Type Notes distributed as widely as 
  29. possible.  We send them to all Partners and Associates at no charge, and we 
  30. also post them on AppleLink in the Developer Services bulletin board and other 
  31. electronic sources, including the Apple FTP site (IP 130.43.2.2).  You can 
  32. also order them through APDA.  As an APDA customer, you have access to the 
  33. tools and documentation necessary to develop Apple-compatible products.  For 
  34. more information about APDA, contact:
  35.  
  36.                     APDA
  37.                     Apple Computer, Inc.
  38.                     20525 Mariani Avenue, M/S 33-G
  39.                     Cupertino, CA 95014
  40.                     (800) 282-APDA or (800) 282-2732
  41.                     Fax:  (408) 562-3971
  42.                     Telex:  171-576
  43.                     AppleLink:  APDA
  44.                     Internet:  APDA@AppleLink.Apple.com
  45.  
  46. We place no restrictions on copying the Notes, with the exception that you 
  47. cannot resell them.  You should note, however, that some of the file formats 
  48. are the copyrighted property of the companies which own them.  These formats 
  49. are identified in the appropriate Notes, and you should treat them with 
  50. respect to the applicable copyright laws.
  51.  
  52. All file type and auxiliary type combinations not listed in this Note are 
  53. reserved and must not be used by applications without assignment from Apple 
  54. Computer, Inc.
  55.  
  56.  
  57. Specifically, you may not do the following:
  58.  
  59.   o  You may not use auxiliary type $0000 for a given file type instead 
  60.      of asking for an assignment.
  61.   o  You may not use an auxiliary type in file type $BF, justifying it 
  62.      with, "My program runs under GS/OS and creates documents."
  63.   o  You may not pick your own auxiliary type in a given file type and 
  64.      use it without getting an assignment from Apple.  You may request 
  65.      a specific auxiliary type if you desire, but you must be prepared 
  66.      for the instance in which your requested auxiliary type is not 
  67.      available.
  68.   o  You may not redefine the auxiliary type of a file type to suit 
  69.      your own purposes.  For example, you can't choose to use auxiliary 
  70.      type $ABCD in file type $04, since the auxiliary type of file type 
  71.      $04 (text file) is already defined to be the record length of a 
  72.      random-access text file.
  73.  
  74. You may use file types and auxiliary types which are not assigned to you if a 
  75. complete definition of the contents of the file is published in File Type 
  76. Notes or elsewhere.  For example, you do not need to be assigned auxiliary 
  77. types to use text files or binary files.
  78.  
  79. If you have any questions at all about file type and auxiliary type policies, 
  80. assignments, or other specifics, do not hesitate to contact Developer 
  81. Technical Support at the address listed in this Note.
  82.  
  83. Developer Technical Support requires four things from a developer before 
  84. publishing a file format for your application in a File Type Note:
  85.  
  86.   1.  The file format itself, preferably in an ASCII text file.
  87.   2.  Assurances that the product is shipping.  We don't want to jump 
  88.       the gun by releasing a Note for an unannounced product or a 
  89.       product which is unavailable.  The enclosed list of file type 
  90.       assignments includes only those products which we know are 
  91.       currently shipping.
  92.  
  93. Note:  If your product is shipping, but your file type is not 
  94.        listed, you need to contact DTS, since engineering uses this 
  95.        list to identify files in future Apple products, such as 
  96.        future releases of the Apple IIgs Finder.  If this Note does 
  97.        not list your file type and auxiliary type assignments, 
  98.        engineering cannot include them in future products.  The 
  99.        "short" names listed in this Note are used as the 
  100.        descriptors for such files, so you should contact DTS if a 
  101.        descriptor for one of your files is unsuitable.
  102.  
  103.        You must inform DTS when the program using your file type 
  104.        assignments ships to be included in future versions of the 
  105.        system software, even if you do not wish the file format to 
  106.        be published.
  107.  
  108.   3.  Written permission to publish the file format.  We don't want you 
  109.       to submit the format and then be surprised when we publish it.
  110.   4.  Your company name and address, so we can refer readers to you for 
  111.       more information about your product.
  112.  
  113.  
  114.  
  115. Definitions
  116.  
  117. The following definitions apply to all Apple II File Type Notes and will not 
  118. be repeated in each Note:
  119.  
  120. Boolean        A binary indicator stored as a word unless otherwise 
  121.                indicated.  If any bit of a boolean is set, the boolean is 
  122. TRUE.          If it is clear, it is FALSE.
  123. Byte           An 8-bit value.
  124. Double Long    A 64-bit value, composed of eight byte, four words or two 
  125.                long words.  The most significant byte is stored last.
  126. Fixed          A four-byte signed value where the least significant word 
  127.                represents a fractional part and the most significant word 
  128.                represents an integer part (i.e., the value 32767.0 would be 
  129.                stored as $00 $00 $FF $7F to represent the integer part of 
  130.                $7FFF (+32767) and the fractional part of $0000 (0)).  The 
  131.                value 4.5 would be stored as $00 $80 $04 $00 to represent 
  132.                the integer part of $0004 and the fractional part of $8000.  
  133.                The value $8000 is represented as 1000000000000000 in 
  134.                binary.  The bit immediately following the decimal point is 
  135.                set, which indicates the value of 2^-1, or one-half.  The 
  136.                full binary expansion of 4.5 is 
  137.                0000000000000100.1000000000000000, which indicates 
  138.                2^2 + 2^-1 or 4 + 0.5, which is 4.5.  The Apple IIgs 
  139.                Integer Math Tools contain routines to assist with 
  140.                Fixed arithmetic.
  141. Flag unit      Any storage unit (byte, word, long) treated as a series of 
  142.                flag bits rather than as a numeric value.
  143. Long           A 32-bit value, composed of four bytes or two words.  The 
  144.                most significant byte is stored last.  For example, 
  145.                $00E102A8 would be stored as $A8 $02 $E1 $00.
  146. Reverse        The 65xxx series microprocessors normally store values with 
  147.                the least significant byte (LSB) first, while other 
  148.                microprocessors may store values with the most significant 
  149.                byte (MSB) first.  The designation Reverse (Rev.) indicates 
  150.                that values must be rearranged before using them  (i.e., a 
  151.                Long value of $11223344 would be stored as $44 $33 $22 $11, 
  152.                but a Reverse Long value would be stored as $11 $22 $33 $44).
  153. String         A Pascal-type string.  It consists of a length byte followed 
  154.                by up to 255 bytes of ASCII data.
  155. Word           A 16-bit value, composed of two bytes.  The most significant 
  156.                byte of the word is stored after the least significant byte.  
  157.                For example, $02FF would be stored $FF $02.
  158.  
  159. All bit definitions are given as bit numbers.  Bit 0 is always the least 
  160. significant bit.  The most significant bit of a byte is bit 7; the most 
  161. significant bit of a word is bit 15, etc.
  162.  
  163. Following is a current list of all file type and auxiliary type assignments.  
  164. Assignments with a date indicate the release date of the File Type Note for 
  165. that assignment, and all file types and auxiliary types which are not listed 
  166. in this Note are reserved and should not be used.
  167.  
  168. Although Apple strongly recommends the use of file type descriptors, this 
  169. document includes a list of three-letter abbreviations solely for developer 
  170. convenience.  These abbreviations are final as documented and will not be 
  171. changed.
  172.  
  173. _____________________________________________________________________________
  174.  
  175. File Type Assignments                                          September 1990
  176.  
  177. * = Finder identifies for System Software 5.0                         New ***
  178. + = Finder identifies for System Software 5.0 only on machines    Revised *R*
  179.     with more than 512K memory
  180.  
  181.  
  182. File Aux.   3Ltr File Type Description
  183. Type Type   Abv  (File Type Owner)           Auxiliary Type Description  Date
  184. $00*        UNK  Unknown                                                03/90
  185. $01*        BAD  Bad blocks                                             03/90
  186. $02+        PCD  Apple /// Pascal code
  187. $03+        PTX  Apple /// Pascal text
  188. $04*        TXT  ASCII text                  Random-access record-length
  189. $05+        PDA  Apple /// Pascal data
  190. $06*        BIN  Binary                      Load address in bank 0
  191. $07+        FNT  Apple /// Font
  192. $08*        FOT  Apple II or /// Graphics                               05/89
  193. $08+ $4000       Packed Hi-Res Image         Image Format               11/88
  194. $08+ $4001       Packed Double Hi-Res Image  Image Format               11/88
  195. $09+        BA3  Apple /// BASIC program
  196. $0A+        DA3  Apple /// BASIC data
  197. $0B+        WPF  Apple /// Word Processor
  198. $0C+        SOS  Apple /// SOS System
  199. $0F*        DIR  Folder
  200. $10+        RPD  Apple /// RPS data
  201. $11+        RPI  Apple /// RPS index
  202. $12+        AFD  Apple /// AppleFile discard
  203. $13+        AFM  Apple /// AppleFile model
  204. $14+        AFR  Apple /// AppleFile report format
  205. $15+        SCL  Apple /// screen library
  206. $16+        PFS  PFS document
  207. $16+ $0001       PFS:File document           Program Specific
  208. $16+ $0002       PFS:Write document          Program Specific
  209. $16+ $0003       PFS:Graph document          Program Specific
  210. $16+ $0004       PFS:Plan document           Program Specific
  211. $16+ $0016       PFS internal data           Program Specific
  212. $19* ADB         AppleWorks Data Base        Upper-/lowercase in name   07/90
  213. $1A*        AWP  AppleWorks Word Processor   Upper-/lowercase in name   09/89
  214. $1B*        ASP  AppleWorks Spreadsheet      Upper-/lowercase in name   09/89
  215. $20+        TDM  Desktop Manager document
  216. $21              Instant Pascal source
  217. $22              UCSD Pascal Volume
  218. $29+             Apple /// SOS Dictionary
  219. $2A+        8SC  Apple II Source Code        Application Specific
  220. $2B+        8OB  Apple II Object Code        Application Specific
  221. $2C+        8IC  Apple II Interpreted Code   Application Specific
  222. $2D+        8LD  Apple II Language Data      Application Specific
  223. $2E         P8C  ProDOS 8 code module        Application Specific
  224. $42*        FTD  File Type Names             Search order               07/89
  225. $50*        GWP  Apple IIGS Word Processor
  226. $50  $5445       Teach                       Application Specific       03/90
  227. $50+ $8001       DeluxeWrite document        Application Specific
  228. $50+ $8010       AppleWorks GS Word          Application Specific    *R*09/90
  229.                  Processor
  230. $51*        GSS  Apple IIGS Spreadsheet
  231. $51+ $8010       AppleWorks GS Spreadsheet   Application Specific
  232. $52*        GDB  Apple IIGS Data Base
  233. $52+ $8010       AppleWorks GS Data Base     Application Specific
  234. $52+ $8011       AppleWorks GS DB Template   Application Specific
  235. $53*        DRW  Drawing
  236. $53  $8002       Graphic Disk Labeler        Application Specific       03/90
  237.                  document 
  238. $53+ $8010       AppleWorks GS Graphics      Application Specific
  239. $54*        GDP  Desktop Publishing
  240. $54+ $8010       AppleWorks GS Page Layout   Application Specific
  241. $54+ $DD3E       Medley document             Application Specific       05/89
  242. $55*        HMD  Hypermedia                  Application Specific
  243. $55+ $8001       Tutor-Tech document         Application Specific
  244. $55+ $8002       HyperStudio document        Application Specific
  245. $56*        EDU  Educational Data            Application Specific
  246. $56+ $8001       Tutor-Tech Scores           Application Specific
  247. $57*        STN  Stationery
  248. $58*        HLP  Help File
  249. $59*        COM  Communications File         Application Specific
  250. $59+ $8010       AppleWorks GS               Application Specific
  251.                  Communications 
  252. $5A*        CFG  Configuration file          Application Specific
  253. $5A  $0002       Battery RAM configuration                              05/90
  254. $5A+ $8001       Master Tracks Jr. preferences
  255. $5A+ $8010       AppleWorks GS               Application Specific
  256.                  configuration
  257. $5B*        ANM  Animation file              Application Specific
  258. $5B+ $8001       Cartooners movie            Application Specific
  259. $5B+ $8002       Cartooners actors           Application Specific
  260. $5C         MUM  Multimedia document         Application Specific
  261. $5D         ENT  Game/Entertainment          Application Specific
  262.                  document 
  263. $5E         DVU  Development utility         Application Specific
  264.                  document 
  265. $5E  $0001       Resource file                                          05/90
  266. $6B+        BIO  PC Transporter BIOS
  267. $6D+        TDR  PC Transporter driver
  268. $6E+        PRE  PC Transporter pre-boot
  269. $6F+        HDV  PC Transporter volume
  270. $A0*        WP   WordPerfect document        WordPerfect                01/89
  271. $AB+        GSB  Apple IIGS BASIC program
  272. $AC+        TDF  Apple IIGS BASIC TDF
  273. $AD+        BDF  Apple IIGS BASIC data
  274. $B0*        SRC  Apple IIGS  source code     APW Language type          07/90
  275. $B0+ $0001       APW Text file
  276. $B0+ $0003       APW 65816 Assembly source code
  277. $B0+ $0005       ORCA/Pascal source code
  278. $B0+ $0006       APW command file
  279. $B0+ $0008       ORCA/C source code
  280. $B0+ $0009       APW Linker command file
  281. $B0+ $000A       APW C source code
  282. $B0+ $000C       ORCA/Desktop command file
  283. $B0+ $0015       APW Rez source file
  284. $B0+ $001E       TML Pascal source code
  285. $B1*        OBJ  Apple IIGS object code
  286. $B2*        LIB  Apple IIGS Library file
  287. $B3*        S16  GS/OS application                                      09/89
  288. $B4*        RTL  GS/OS Run-Time Library
  289. $B5*        EXE  GS/OS Shell application                                09/89
  290. $B6*        PIF  Permanent initialization    Not loaded if bit 15 set***09/90
  291.                  file
  292. $B7*        TIF  Temporary initialization    Not loaded if bit 15 set***09/90
  293.                  file
  294. $B8*        NDA  New desk accessory          Not loaded if bit 15 set***09/90
  295. $B9*        CDA  Classic desk accessory      Not loaded if bit 15 set***09/90
  296. $BA*        TOL  Tool                                                ***09/90
  297. $BB*        DVR  Apple IIGS Device Driver    Not loaded if bit 15 set   11/89
  298.                  File 
  299. $BC*        LDF  Load file (generic)                                    07/90
  300. $BD*        FST  GS/OS File System           Not loaded if bit 15 set***09/90
  301.                  Translator
  302. $BF+        DOC  GS/OS document
  303. $C0*        PNT  Packed Super Hi-Res         Application Specific
  304.                  picture
  305. $C0+ $0000       Paintworks Packed picture   Application Specific       11/88
  306. $C0+ $0001       Packed Super Hi-Res Image   Application Specific       11/88
  307. $C0+ $0002       Apple Preferred Format      Application Specific    *R*09/90
  308.                  picture
  309. $C0+ $0003       Packed QuickDraw II PICT    Application Specific       11/88
  310.                  file
  311. $C1*        PIC  Super Hi-Res picture        Application Specific       11/88
  312. $C1+ $0000       Super Hi-Res Screen image   Application Specific       11/88
  313. $C1+ $0001       QuickDraw PICT file         Application Specific       11/88
  314. $C1  $0002       Super Hi-Res 3200 color                             ***09/90
  315.                  screen image
  316. $C2+        ANI  Paintworks animation
  317. $C3+        PAL  Paintworks palette
  318. $C5*        OOG  Object-oriented graphics    Application Specific
  319. $C5+ $8000       Draw Plus document          Application Specific
  320. $C5+ $C000       DYOH: Architecture          Application Specific
  321.                  document
  322. $C5+ $C001       DYOH predrawn objects       Application Specific
  323. $C5+ $C002       DYOH custom objects         Application Specific
  324. $C5+ $C003       DYOH clipboard              Application Specific
  325. $C5+ $C006       DYOH: Landscape Document    Application Specific
  326. $C6         SCR  Script                      Application Specific
  327. $C7*        CDV  Control Panel document      Not loaded if bit 15 set*R*09/90
  328. $C8*        FON  Font
  329. $C8  $0000       Font (Standard Apple IIGS   Reserved                   01/89
  330.                  QuickDraw II Font)
  331. $C9*        FND  Finder data
  332. $CA*        ICN  Icons                                                  07/89
  333. $D5*        MUS  Music sequence              Application Specific       01/90
  334. $D5+ $0000       Music Construction Set      Application Specific
  335.                  song
  336. $D5  $0007       SoundSmith document         Application Specific       03/90
  337. $D5+ $8002       Diversi-Tune sequence       Application Specific
  338. $D5  $8003       Master Tracks Jr. sequence  Application Specific
  339. $D6*        INS  Instrument                  Application Specific       01/90
  340. $D6+ $0000       Music Construction Set      Application Specific
  341.                  inst.
  342. $D6+ $8002       Diversi-Tune instrument     Application Specific
  343. $D7*        MDI  MIDI data                                              01/90
  344. $D7+ $0000       MIDI standard data          Application Specific
  345. $D8*        SND  Sampled sound               Application Specific       01/90
  346. $D8+ $0000       Audio IFF document          Application Specific       03/89
  347. $D8+ $0002       ASIF instrument             Application Specific       03/89
  348. $D8  $8003       Sampled Sound resource      Application Specific
  349. $D8+ $8001       HyperStudio sound           Application Specific       05/90
  350. $DB*        DBM  DB Master document          Application Specific
  351. $DB+ $0001       DB Master document          Application Specific
  352. $E0*        LBR  Archival library            Application Specific
  353. $E0+ $0000       ALU library                 Carolina System Software
  354. $E0  $0001       AppleSingle File            Application Specific       03/90
  355. $E0  $0002       AppleDouble Header File     Application Specific       03/90
  356. $E0  $0003       AppleDouble Data File       Application Specific       03/90
  357. $E0  $8000       Binary II File              Application Specific       07/89
  358. $E0+ $8001       AppleLink ACU document      Application Specific
  359. $E0+ $8002       ShrinkIt (NuFX) document    Application Specific       07/90
  360. $E0  $8004       Davex archived volume                                  05/90
  361. $E0  $8006       EZ Backup Saveset document                          ***09/90
  362. $E2*        ATK  AppleTalk data
  363. $EE         R16  EDASM 816 relocatable file
  364. $EF+        PAS  Pascal area
  365. $F0+        CMD  BASIC command
  366. $F1*             User #1
  367. $F2*             User #2
  368. $F3*             User #3
  369. $F4*             User #4
  370. $F5*             User #5
  371. $F6*             User #6
  372. $F7*             User #7
  373. $F8*             User #8
  374. $F9*        OS   GS/OS System file
  375. $FA+        INT  Integer BASIC program
  376. $FB+        IVR  Integer BASIC variables
  377. $FC*        BAS  AppleSoft BASIC program
  378. $FD*        VAR  AppleSoft BASIC variables
  379. $FE+        REL  Relocatable code
  380. $FF*        SYS  ProDOS 8 application
  381.  
  382. _____________________________________________________________________________
  383.  
  384.